home *** CD-ROM | disk | FTP | other *** search
/ MacTech 1 to 12 / MacTech-vol-1-12.toast / Tools / Drop•Rename 3.0.2 ƒ / Documentation < prev    next >
Text File  |  1996-12-28  |  10KB  |  118 lines

  1. Drop•Rename 3.0.2 • Documentation
  2. SouthSide Software (SouthSide@kagi.com)
  3. ©1994-1997 Bob Bradley, All Rights Reserved.
  4. This application is $10 shareware.
  5.  
  6. What is Drop•Rename?
  7.  
  8. Drop•Rename is a fast and powerful renaming tool. It allows you to rename files or folders with a variety of options. You can search for a string in a filename and replace it with another string. Insert a string anywhere in a filename. Remove a string or a specific number of characters from anywhere within a filename. Change the case of a filename or capitalize only the first letter of each word. Sequentially number multiple items with a variety of options. Truncate filenames to MS-DOS format or to a specific length and optionally remove vowels. Each of these options can be applied multiple times and more than one operation can be done at once. Each rename action can be conditional so that certain criteria must be met before the rename action is executed. It's fully multi-threaded so it won't hog the CPU and operates flawlessly in the background or while you're using other parts of the application. Best of all, you can also create Renamelets, customized self-running applications for common operations you perform.
  9.  
  10. What does Drop•Rename require to run?
  11.  
  12. Drop•Rename should run on any Macintosh running System 7.x.x with the Thread Manager or System 7.5.x (which has the Thread Manager built-in). It has been tested on a PowerMac 9500, PowerMac 8500, PowerMac 6100/60, PowerCurve 601/120, and a Macintosh IIfx with the following System's: System 7.5.5, 7.5.3, 7.5.2, 7.5.1, 7.1.2, and 7.1.1.
  13.  
  14. How do I use Drop•Rename?
  15.  
  16. Using Drop•Rename is simple. Drop any file, folder, or mixture of the two onto the Drop•Rename icon. You will be presented with a dialog with which you can setup your rename criteria, describing how you want the files renamed.
  17.  
  18. •••IMPORTANT: If you can't drop anything onto the Drop•Rename icon, try rebuilding your desktop.
  19.  
  20. Here's descriptions of each type of rename action:
  21.  
  22. Search:
  23. Allows you to search for a string and replace it with another string, in a filename. You have the option to ignore case or make it case sensitive. You can also specify if you would like the filename to be searched and replaced recursively to replace every occurrence of the search string, not just the first one. You can also do wildcard searches.
  24.  
  25. Insert:
  26. Allows you to insert or append a string to a filename. You can insert the string anywhere in the filename, at the beginning, at the end, at an offset from the beginning of the filename, or at an offset from the end of the filename.
  27.  
  28. Remove:
  29. Allows you to remove a string from a filename or remove a specific number of characters from a filename. When removing a string, you have the option to ignore case or make it case sensitive. You can also specify if you would like to remove recursively to remove every occurrence of the search string, not just the first one. When removing a specific number of characters, you have the option to remove the characters from the beginning of the filename, from the end of the filename,  from an offset from the beginning of the filename, or from an offset from the end of the filename. You can also do wildcard removes.
  30.  
  31. Change Case:
  32. Allows you to change the case of the filename to UPPERCASE, lowercase, or to capitalize the beginning of each word. You can also change the first letter of the filename to uppercase and change the rest to lowercase as well as changing the first letter of the filename to uppercase and ignoring the rest.
  33.  
  34. Number:
  35. Allows you to sequentially number a group of items. You can start the numbering from any number and have it incremented by any number. The number can be inserted anywhere within the filename, at the beginning, at the end, at an offset from the beginning of the filename, or at an offset from the end of the filename. You have the option to pad the number with leading zeros so the number order is still maintained. You can also specify a base filename that all files will be renamed to and then numbered. This allows you to number a group of items to the same name with each only differing by their number. You can also increment backwards.
  36.  
  37. Truncate:
  38. Allows you to truncate a filename to MS-DOS format or to a specific number of characters. Truncating to MS-DOS format will remove any characters MS-DOS doesn't handle and will make sure the filename does not exceed the 8 character + 3 character extension limit. You can also truncate a filename to a specific length. Both types of truncation allow you to remove all vowels from the filename. Many times vowels can be removed from a filename to shorten it while still remaining legible.
  39.  
  40. Balloon help is also extensively supported so check that out if you need more help while you're using the application.
  41.  
  42. What is an Renamelet?
  43.  
  44. A Renamelet is a customized self-running application that you can create with Drop•Rename. Renamelet can save you a lot of time and effort by encapsulating common operations you may perform into a single application that requires no setup. Just drop the files you want to process on the icon and that's it. For example, if you frequently remove the ".sit" and ".cpt" from files, you could create a Renamelet for it so you don't have to type that information into Drop•Rename each time. You can also make it conditional so that, for example, only files of type 'TEXT' will be renamed, etc... Multiple rename actions can be put into a Renamelet, in fact, anything you can do with Drop•Rename can be done in a Renamelet. The possibilities are endless!
  45.  
  46. How much does Drop•Rename cost?
  47.  
  48. Drop•Rename is shareware, which means if you like it and continue to use it, you should pay for it.
  49.  
  50. The cost is $10 for a single-user license, $200 for a site license (unlimited use at a single site), and $1000 for a world-wide site license (unlimited use at as many sites as you need). All prices and options are shown in the Register application.
  51.  
  52. If you purchased a previous version of Drop•Rename, this update is free.
  53.  
  54. How do I pay for Drop•Rename?
  55.  
  56. To register, run the Register application, included in this package (or contact me and I'll send it to you), to fill out the registration form. Once you've filled it out, you have 3 options for paying:
  57.  
  58. 1) Print it and send it, together with your payment, to Kagi Shareware at:
  59.  
  60. Kagi Shareware
  61. 1442-A Walnut Street #392-BB
  62. Berkeley, California 94709-1405
  63. USA
  64.  
  65. This address is also on the registration form that the Register application prints.
  66.  
  67. 2) E-Mail it by clicking "Copy" in the Register application and pasting it into the body of your e-mail message to:
  68.  
  69. shareware@kagi.com
  70.  
  71. 3) Fax it by printing it then faxing the printed registration form to this number:
  72.  
  73. 1-510-652-6589
  74.  
  75. If you have any questions, don't hesitate to contact me at SouthSide@kagi.com.
  76.  
  77. The payment options are shown in the Register application. You can pay with cash (in many currencies), check, credit card (VISA, MasterCard, or AmEx), or various other forms of payment (check out the Register application for other forms of payment).
  78.  
  79. Once you have registered, click “I Have Paid” in the preferences dialog to register the application and stop the About dialog from coming up each time you use the application.
  80.  
  81. Can I distribute Drop•Rename?
  82.  
  83. Yes, please do! You may distribute this application anyway you want as long as you include the documentation and Register application and do not charge for it. Reasonable media and distribution costs excluded. I want as many people to get this as possible. 
  84.  
  85. Aren't you afraid people will use it and not pay for it?
  86.  
  87. No. Obviously, there’s no way I can tell if you’re using this application without paying for it nor would I even want to know. I do not believe in copy protection in any form for a number of reasons but, most importantly cause copy protection shows an unjustified distrust for the user. This is why there is no protection in this application, any other software I’ve written or will write in future. I do have a simple reminder that this application is shareware and should be purchased, if use is continued but, as stated above, clicking the “I Have Paid” checkbox in the preferences dialog removes this reminder. I feel this is the best method as I want the user to understand this application is shareware and requires a fee but, also do not want to annoy the user with copy protection that implies the user is not trustworthy and must show proof of payment. Your word is good enough for me.
  88.  
  89. What did you use to create Drop•Rename?
  90.  
  91. Drop•Rename was written in C and C++ using Metrowerks CodeWarrior. Resources were created and edited with Resorcerer. Finder icons for Drop•Rename were created by AP.
  92.  
  93. Do you have anyone to thank?
  94.  
  95. Too many to name them all but, here's a few:
  96.  
  97. Chris Larson (larson@cs.ucla.edu) for his Finder Progress Bar 2.0 CDEF.
  98.  
  99. AP for creating the icons, suggestions, and testing.
  100. John Norstad for releasing the source code to NewsWatcher. It has helped me enormously.
  101. Peter N. Lewis for helping with the thread communication code along with other general help.
  102. Dr. Fred Condo and Dennis Hescox at Lightside for helping with programming and providing Internet access.
  103. Kagi Shareware for providing an excellent service for shareware authors.
  104. All the people on CSMP and everyone who sent me thanks, problems,  suggestions, and help.
  105. Thanks to all the people who have registered.
  106.  
  107. What other stuff have you written?
  108.  
  109. Drop•Attribute • Type/Creator/Attribute Changer. $10 Shareware
  110.  
  111. And many more to come...If you'd like to see other applications, contact me with the specifications and I'll give it a shot.
  112.  
  113. Where can I contact you?
  114.  
  115. If you like this program or even think it sucks, let me know. I always answer my mail so, if you don't get a response, I may not have received it and you should send it again.
  116.  
  117. For help or information about this application and/or SouthSide Software, send mail to SouthSide@kagi.com.
  118. For information about Kagi Shareware and/or the Register application, send mail to shareware@kagi.com.